Connect to Mart

If you are using erwin Data Modeler Workgroup Edition, you must connect to the Mart to access models and perform administrative functions.

erwin DM connects to the Mart through a web server. You can connect multiple instances of erwin DM to the Mart from your computer.

Starting erwin DM and erwin Mart Server (MS) 2019R1, while connecting erwin DM to erwin MS, version validation has been implemented as follows:

  1. Connection from erwin DM 2019R1 to erwin MS lower than 2019R1 is not allowed.
  2. Connection from erwin DM lower than 2019R1 to erwin MS 2019R1 is not allowed.

Starting release 12.1, erwin Mart Server is available in two flavors, on-premise and on-cloud. To be able to use erwin Mart on Cloud, the baseline version for both, erwin DM and erwin Mart Server is 12.1.

To connect to mart, follow these steps:

  1. Click MartConnect on the toolbar, or on the ribbon, go to Mart > Connect.

    The Connect to Mart screen opens.

  2. Based on your erwin Mart flavor, enter values to the following fields:

    Field

    Description

    Additional Information

    Server Name

    Specifies the name of the web server where you have installed the Mart
    • Mart on premises:
      Indicates the server where your Mart is installed

      For example, localhost or an IP address

    • Mart on cloud:
      Indicates the server's name where you access your Mart.

      For example, company.myerwin.com

      The server name follows the <servername>.myerwin.com format.

    Port

    Specifies the port number to access the web server

    Default port numbers are as follows:

    • Mart on premises: 18170

    • Mart on cloud: 443

    Use IIS

    Specifies whether to use the IIS web server to connect to Mart

    This option is enabled only if you have configured IIS.

    If you use IIS, open server.xml file available at C:\Program Files\erwin\Mart Server r9\Tomcat64\conf and un-comment <Connector port="8009" protocol="AJP/1.3" allowedRequestAttributesPattern=".*" redirectPort="8443" secretRequired="false"/>.

    IIS PortSpecifies the IIS port number that you want to useThis option is enabled only if you select the Use IIS check box. The default is 80.
    Use SSL (https)

    Specifies whether you want to connect to the Mart through a secured connection

    SSL lets you access the Mart through a secured connection. This check box is enabled only if you have configured SSL on your web server.

    To connect to erwin Mart on Cloud, ensure that you select the Use SSL (https) checkbox.

    If you use IIS with SSL, open server_ssl.xml file, which is available at C:\Program Files\erwin\Mart Server r9\Tomcat64\conf and un-comment Connector port="8009" protocol="AJP/1.3" allowedRequestAttributesPattern=".*" redirectPort="8443" secretRequired="false"/>.

    Application Name

    Specifies the application name of the Mart

    Application names are as follows:

    • Mart on premises: MartServer

    • Mart on cloud: MartServerCloud

    AuthenticationSpecifies the type of authentication to connect to Mart
    • Server Authentication: Indicates that the Mart connection uses an erwin Mart Server-authenticated user.

    • Windows Authentication: Indicates that the Mart connection uses a Windows-authenticated user.

    User NameSpecifies the username of a Mart account

    A local Windows user who does not belong to a domain or who is not part of an Active Directory cannot log in to the Mart as a Windows user.

    PasswordSpecifies the password of a Mart account

    Entering an incorrect password five consecutive times locks your account for five minutes (300 seconds) by default. To change the default lock out time, refer to the Change Default Account Lockout Duration section.

    A password should fulfil the following criteria:

    • Contains at least 1 lowercase character

    • Contains at least 1 uppercase character

    • Contains at least 1 number

    • Is minimum 6 characters in length

    • Is maximum 130 characters in length

    Apart from the above criteria, special characters are optional.

  3. Click Connect.

    If you have selected Use SSL and the security certificate is installed, you are connected to the Mart.

    For erwin Mart on Cloud, only one session per user is allowed. That is, you can either use erwin Mart Administrator on cloud or connect to erwin Mart on Cloud via erwin Data Modeler.
    For example, if you are logged on to erwin Mart Administrator and then, connect to erwin Mart on Cloud via erwin Data Modeler, your erwin Mart Administrator session is terminated.

    After you connect to the Mart, if you click Connect again, a dialog opens seeking your permission to disconnect from the Mart.

    If your security certificate is not installed, a message, The certificate authority is invalid or incorrect, appears. You must install the security certificate to proceed.

    1. Click OK on the message.

      The SSL Certificate Install dialog appears.

    2. Click Install.

      The Certificate dialog appears.

    3. Click Install Certificate.

      The Certificate Import Wizard dialog appears.

    4. Click Next.
    5. Click the Place all certificates in the following store option button and click Browse.
    6. In the Select Certificate Store dialog, select Trusted Root Certification Authorities and click OK.
    7. Click Finish.

      The security certificate is installed and you are connected to the Mart.

More information:

Mart Architecture

Disconnect from Mart

SSL Security Certificate

If your Mart is SSL security-enabled, you must install the security certificate, when you access the Mart for the first time. The System Administrator creates a security certificate while implementing SSL. Install the certificate on every computer that you use to connect to the Mart.

Ensure that you install the certificate under the Trusted Root Certification Authorities certificate store.

Changing the Default Account Lockout Duration

To change the default account lockout duration, follow these steps:

  1. On Windows Start menu, click All Programs > erwin > Mart Server 12.1 > Configure MartServer.

    The erwin Mart Configuration dialog appears.

  2. On the Mart Administrator tab, edit the value of the Account Lockout Duration (Seconds) field to an appropriate value. At the most, you can set it to 30 days (2592000 seconds).